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PREFACE 

Support for Time Sharing (STS) is a support operating system designed to provide a set 

of serviceability aids for IBM System/360 Time Sharing System (TSS/360). The reader should 

be familiar with the following publications, in addition to pertinent TSS/360 manuals. 

IBM System/360 Principles of Operations , Form A22-6821 

IBM System/360 Basic Operating System: Programmer's Guide , Form C24-3372 

IBM S3^stem/360 Basic Operating System: Assembler With Input/Output Macros , 
Form C24-3361 

IBM System/360 Basic Operating System: Macro Definition Language (8K Tape) , 
Form C24-3364 



First Edition (October 1967) 

Specifications contained herein are subject to change from time to time. Any such change will be reported in 
subsequent revisions or Technical Newsletters. 

Requests for copies of IBM publications should be made to your IBM representative or to the IBM branch office 

serving your locality. 

A form is provided at the back of this publication for reader's comments. If the form has been removed, com- 
ments may be addressed to IBM Corporation, Time Sharing System/360 Programming Publications, Department 
561, 2651 Strang Boulevard, Yorktown Heights, N. Y. 10598. 

© international Business Machines Corporation 1967 
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INTRODUCTION 



SYSTEM SUMMARY 

STSis bunt upon the supervisor of the IBM System/360 basic operating system (BOS) 
with the addition of a command — recognition routine that directs various transient 
support processors according to commands entered at the 1052-7 console typewriter. 
One of these commands (RUN) is the means by which the mode of system operation 
changes , from support to normal TSS/360 execution. When the system is in normal mode 
all details of TSS/360 design are exactly as described in the documentation of the TSS 
resident monitor; that is, the resident monitor does not "know" that a support supervisor 
is interposed between the hardware and itself. Support mode is usually entered by 
pressing the CPU interrupt key, followed by pressing the attention button on the IBM 
1052-7. During support mode, no execution of TSS/360 takes place with the 
exception of the stacking of interrupts for later processing. 

This manual describes the commands available in support mode and gives examples 
of typical use. 

INTERFACE WITH THE TSS/360 RESIDENT MONITOR 

To provide an adequate background for understanding the support commands , it is 
necessary to describe the interface between STS and the TSS resident monitor. IPL 
of the system residence volume results in initialization and loading of the various 
components of the time sharing system, including the loading of the STS supervisor into 
a reserved area (X T 1000 ! to X T 6FFF f ) c Control is passed by STARTUP to a point within 
the STS supervisor, which initializes various constants including the addresses in the 
new PSWs and then passes control to the command recognition routine. The operator 
then initializes the I/O device assignments for STS, for the particular installation, 
and performs any other action necessary to prepare the system for execution. Upon 
issuance of the first RUN command, the necessary linkage between STS and the TSS 
resident monitor Is completed. 

Figure 1 shows the assignment of core for the support supervisor, the transient 
processor execution area, the command recognition routine, the prefixed storage area, 
and the remainder of core allocated to TSS/360. Within the support supervisor, an 
area called the communication region provides space for save areas used to hold status 
of the system during execution in support mode, as well as space used by the transient 
processors to communicate with one another. Through the principle of saving system 
status at point of entry to support mode, the various commands may be used to examine 
and modify the state of the system in its "frozen" condition 

To assist the support commands in referring to locations within the TSS resident 
monitor, a program control and symbol table is constructed at system initialization time. 
Details pertinent to dynamic dump requests and communication points are stored within 
this table. 
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TSS/360 Execution Area — » 

Includes Message 
Handling Routines — * 

Contains Save Areas — ■- 

Contains Some STS Pointers — » 

Figure 1. Relationships of Support Supervisor 



PROGRAM CONTROL TABLE 



TRANSIENT AREA 



Command Recognition Routine 



SUPPORT SUPERVISOR 



PSA 



x <7000 f 

x f 38F0 f 

x '3120* 

x r 1000 t 




Only one transient processor (command) executes at one time. Execution is complete 
when the command request is satisfied or the console typewriter attention button is 
depressed to indicate that command recognition is desired. In support mode, the con- 
sole interrupt key need not be depressed to get support attention. The various transient 
processors reside in a data set on the system residence volume; as they are needed, 
the STS supervisor fetches them and gives control to the appropriate entry point. This 
data set is built by a command processor from an input tape produced by another 
command processor which obtains the core image (machine instructions) for each 
transient processor from the core image library of a BOS system volume. The transient 
processors, which consist of one or more "phases" , are assembled and link-edited as In 
any BOS programs . 

Certain SVCs are not allowed to be issued by virtual memory tasks unless their use 
Is for requesting support functions. These are SVC 5 and SVC 10 (described later). 
The resident monitor may issue SVC 6 in order to enter support mode. 

To maintain the integrity of the interface, the TSS resident monitor does not modify 
the addresses in the new PSWs. After stacking the interrupts delivered to it when the 
system is in support mode, the interrupt stacker exits according to an agreed — upon 
convention relating to the resumption of support mode execution. 

SUMMARY OF SUPPORT COMMANDS 



Command 


Operand 


Function 


ASN 


symbolic / physic al 


Symbolic I/O device assignmenl 




CARDS 


command stream is on cards 


RUN 


none/ location 


execute TSS/360 


DIS 


location^) 


display core contents on 1052-7 




PUB 


display physical unit block 




GR 


display general registers 




FR 


display floating point registers 




CR 


display control registers 




CSW 


display channel status word 



SUMMARY OF SUPPORT COMMANDS (Continued) 



Command 



Operand 



Function 



DIS (cont. ) 



CAW 

PSW 

EXTPSW 

SVCPSW 

MCPSW 

IOPSW 

2301 

2311 

2314 

VM locations 

VM GR 

VMFR 

VM PPSW 

VM SPSW 

VM XPSW 

VM APSW 

VM TPSW 

VM IPSW 



display channel address word 

display program, status word 

display external old PSW 

display supervisor call old PSW 

display machine check old PSW 

display input/ output old PSW 

display drum records 

display 2311 disk records 

display 2314 disk records 

display virtual memory contents 

display virtual memory general register 

display virtual memory floating pt. register 

display virtual memory program intpt. PSW 

display virtual memory SVC PSW 

display virtual memory external intpt. PSW 

display virtual memory asynchronous int PSW 

display virtual memory timer intpt. PSW 

display virtual memory I/O intpt. PSW 



DUM 



location/ location 

ATD 

MAP 

2301 

2311 

2314 

VM location/ location 

VM MAP 



dump core contents to SYS001/SYS010 

dump selected TSS tables and task status 

dump resident monitor symbol map 

dump drum records 

dump 2311 disk records 

dump 2314 disk records 

dump virtual memory contents 

dump virtual memory map 



PAT 



location 

CARDS 

GR 

FR 

CR 

PSW 

SYM 

DDR 

CMP 

2301 

2311 

2314 

VM location 

VM GR 

VMFR 

VM PSW 



patch core contents 

patch command stream is on cards 

patch general registers 

patch floating point registers 

patch control registers 

patch program status word 

patch symbol table with new symbol 

patch dynamic dump request 

patch communication point 

patch drum records 

patch 2311 disk records 

patch 2314 disk records 

patch virtual memory contents 

patch virtual memory general register 

patch virtual memory floating pt, register 

patch virtual memory program status word 



DEL 



DDR 
CMP 



delete dynamic dump request 
delete communication point 



SET 



PAUSE 



set pause at point of specific task dispatch 



COMMAND LANGUAGE STATEMENT 



COMMAND FORMAT AND NOTATION 

The general format of command language statements is: 



Command 


Operand 


A command name 


Depending on particular command issued, this 
field may be blank, contain one operand, or 
more than one operand separated by delimiters. 



The command operator field contains a command name, such as DIS or DUM, that 
identifies the command and its requested action. All commands may be entered in 
lower case. 

The command operand field is separated from the operation field by one or more 
blanks. The operand field itself may be blank for certain commands or may contain 
several operands, separated by delimiters, such as commas. Successive blanks are 
regarded as one delimiter. The conventions used to present operands in the command 
format illustrations are explained later in this section 

Only one command may be processed at a time. Command entry is completed by 
holding down the "alternate code" and then pressing the "5" key on the keyboard. 

OPERAND REPRESENTATION 

Most commands use positional operands. If a positional operand is omitted (the rules 
for omission are explained later) and another positional operand is written to the right 
of the omitted operand, the delimiter that would have preceded the omitted operand must 
be retained. 

Operand Name 

This may be a mnemonic or a phrase that identifies the nature of the operand. Unless 
shown in upper-case letters in the command format, operand name represents a variable 
for which the user must supply specific information. 

Value Mnemonics 

This may be a single word, a phrase, or mnemonic that tells how an operand should be 
written. The value mnemonics in this publication are: 

absolute location 

1-6 hexadecimal characters (if first hex character is alphabetic, it should be 
preceded by a + sign); or * followed by 1-6 decimal digits; the * is mandatory to 
indicate a decimal field is supplied. 

symbol 

used interchangeably with alphname. 



simple expression 

created when a symbol and an absolute location are connected by either a + or - 
operator: 

LOOP + A008 (hex) 
LOOP - *2345 (decimal) 

alphname 

the operand can be written as eight or fewer alphameric characters; the first charac- 
ter must be alphabetic. Examples are: 

RESUP 
UNPKLOOP 
CHECK1 
DUMP02 

code 

the operand can be written as one of a set of coded values (see coded value); these 
values are defined in the command description; e. g. , A8 is the code for the ASN 
and PSV command designating a seven-track tape with 800 bpi, even parity, with 
translator on and converter off. 



hex 



hexadecimal characters, 0-F. The number of hex characters to be coded are speci- 
fied with each command. 



integer 



the operand can be written as one or more numeric characters, using decimal digits 
0-9; example: 

51 may be used for a dynamic dump ID. 
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indirect address 



specifies an address that is to be used indirectly. The address specification is 
followed by a percent sign, %, as follows: 



addr [iint] %J [+int] [%] J . . . 



This specification may be used whenever a simple address is required. 

The most recently used address may be retained and thus used as a base address 
in a simple address specification, as follows: 

& + int 

where & denotes the most recently used address. 

Coded Values 

This is a string of characters that is to be written exactly as shown; in the command 
formats they appear as numbers or upper case letters. 

Positional parameters are represented in one of three ways, shown below. The hy- 
phen, braces, brackets, and the value mnemonics are never written in the actual com- 
mand; they serve only as a convenience in displaying the command format. 



5.1 



Operand 
operand name - value mnemonic 

operand name - coded value 
coded value 



Example From 
Command Format 



beginning address - J alphname 
\ hex 



(simple expression 



format - I X 

VM 
CORE 



The operator actually types in, for each kind of positional operand, the positional 
operand 



R epr e s entation 

J alphname 
beginning address - I hex 

1 simple expression 

format - coded value 

VM 

CORE 

Notational Symbols 



User writes 

The appropriate address, for example: 
LOOP45, 40A, LOOP45+78 

The appropriate format value, either 
X or C 

VM 

CORE 



The symbols listed below are used in the command formats to help the operator decide 
how and when to write certain operands. None of these symbols are written by the 
operator. 

[__ J Brackets indicate that the items, or groups of items within the brackets, 

are optional and may be omitted at the operator's discretion. 

If items are stacked within the brackets, they represent alternate choices. 
Underlining a stacked element means it is the default; i. e. , the system 
automatically assumes the underlined item was the operator f s choice if none 
of the items was entered. For example 

X 
D 

F 

means the operator may write any one of these operands or, if X is his 
choice, he may specify it by default. 



f \ braces indicate the operand is mandatory and one of the alternative items 

within the braces must be included in the command. 

In addition to the notational symbols described above, the commas and spaces have 
a special significance in the command format. 

Commas and spaces are used to separate (i. e. , delimit) operands. Commas are 
given for omitted positional operands, unless no positional operands appear after those 
that are omitted. (Successive spaces are regarded as one space. ) 

COMMAND DESCRIPTION 

Descriptions of the commands in the STS command language follow. Each one has the 
following arrangement: 

1. The command name Is given. 

2. A brief statement of the command's functions is made. 

3. The command format is illustrated, the standard abbreviation for the command 
name is given, and each operand is described. 

4. A description of the command is then given, describing what the command does 
from the operator's standpoint, and noting any restrictions. 

5. Next, all messages that might be issued for the commands are listed, with the 
message number (if any), and the English text of each. Messages appear in this order: 

Prompting 

Response 

Diagnostic 

6. Examples of the use of the command are given. 



Form C28 -2035-0 
Page Revised 3/11/68 
ByTNL N28-3019 



COMMANDS 



ASN — Assign Device Address 

The assign (ASN) command allows temporary changes to be made to the STS PUB 
(physical unit block) table. 



Command 


Operand 


ASN 


sysname - 


- SYSxxx, c c uu-hex devtype 


/-see "\ 

Type ) 

I Table J 


devmode - 


I Mode > 
LTableJ 



sysname 

device symbolic name, written as SYS followed by three alphameric characters to 
form a six-character name; where 

xxx may be one of these coded values 

RDR 

LST 

IPT 

OPT 

OPT 

000-026 

Note : The symbolic names used for STS are in no way related to the symbolic names 
used by TSS/360. 



Type Table 



dd 


Meaning 


CI 


1052 VII 


Printer/ keyboard 


Ul 


2741 


Commimications terminal 


U2 


Mod 35 


Teletype 


U3 


1050 


System on 2702 with 1052 


U4 


1050 


System on 2702 with 1056 


US 


1050 


System on 2702 with 1052/1056 


Dl 


2311 


Disk drive 


D2 


2314 


Direct-access storage facility 


D3 


2301 


Drum 


D4 


2321 


Data cell drive 


D5 


2302 


Disk file 


D6 


2303 


Drum 


Fl 


2280 


Film recorder 


F2 


2282 


Film recorder/ scanner 


LI 


1403 


Printer 


L2 


1443 


Printer 


L3 


1405 


Printer 


L4 


1445 


Printer 



Type Table (Continued) 



dd 


Meaning 


PI 


2540 


Punch 


P2 


1442 


Punch 


P3 


2520 


Punch 


RO 


2671 


Paper tape reader 


Rl 


2540 


Card reader 


R2 


2540 


Using punch read feed feature 


R3 


1442 


Reader/ punch 


R4 


2501 


Reader 


R5 


2520 


Reader/ punch 


RR 


1285 


Optical reader 


SI 


1015 


Inquiry display terminal 


S2 


2250 


Display unit 


S3 


2260 


Display station 


ST 


STR 


STR devices on 2701 


Tl 


2400 


Seven-track tape 


T2 


2400 


Nine -track tape 



Mode Table 

For 7-Track Tapes (Type Tl) 



MM 


Density 


Parity 


Translator 


Converter 


10 


200 


Odd 


Off 


On 


20 


200 


Even 


Off 


Off 


28 


200 


Even 


On 


Off 


30 


200 


Odd 


Off 


Off 


38 


200 


Odd 


On 


Off 


50 


556 


Odd 


Off 


On 


60 


556 


Even 


Off 


Off 


68 


556 


Even 


On 


Off 


70 


556 


Odd 


Off 


Off 


78 


556 


Odd 


On 


Off 


90 


800 


Odd 


Off 


On 


AO 


800 


Even 


Off 


Off 


A8 


800 


Even 


On 


Off 


BO 


800 


Odd 


Off 


Off 


B8 


800 


Odd 


On 


Off 



For 1403 with feature installed (EC 125632) 



Mode Bytes 


Meaning 


73 


IGNORE DATA CHECK 


7B 


ACCEPT DATA CHECK 
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C 1 C 2 UU 



device physical address, in the form of c c uu; where 
c = channel controller 0-7 
c = channel number 0-7 
uu = control unit and device 00-FF 



devtype device type — see Type Table, 

devmode device mode — see Mode Table. 



Command 


Operand 


ASN 


CARDS 



CARDS 

cause ASN commands to be read from the card reader assigned to SYSIPT. This 
process ends with a ASN END card. 

Note : It is necessary to assign (ASN) a SYSIPT to the card reader and then execute 
I the command ASN CARDS after each STARTUP of TSS/360. 

RUN — Execute User Program 

The RUN command restores saved status and causes execution to proceed from the 
point of entry to support mode. 



Command 


Operand 


RUN 


location - 


"symbol 

simple expression 

^absolute location 


L state- alphabet! 



location 

an optional operand, specifying the location in storage to which control is to be 
passed for execution. If defaulted, the current setting of the instruction counter is 
used. 

state 

a one-character code 

P- Problem program state 
S - Supervisory state 

Response: 

XXXXXX IS RUNNING 

where XXXXXX is the last user phase (usually RESSUP) 



10 
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Error Responses : 

ILLEGAL TRANSFER LOG. WITHIN SUPERVISOR 

This occurs when the requested transfer location is within the STS supervisor and the 
state is problem program. No transfer will occur. 

CAUTION: TRANSFER LOG. WITHIN SUPERVISOR 

This warning occurs when the requested transfer location is below the STS supervisor 
end location, and the state is supervisory. A transfer will occur as usual. 
Functional Description: The command initially restores the machine registers, then 
determines the physical address (for symbol = displacement), if needed, and sets up 
the PSW - IC -. The supervisor is then called upon to issue a LPSW, which activates 
processing at the specified address in the desired execution mode. 

PIS— Display 

The DISPLAY command provides a means of displaying the contents of storage and 
registers, virtual storage and registers, and direct-access volumes. Output is pre- 
sented on the 1052-7 console. 

Display Real Storage 



Command 



Operand 



DIS 



{ alphname \ 

from address- ) simple expression/ 
1 absolute location i 
'indirect address / 



to address- 



/ alphname ^ 

J simple expression' 

1 absolute location i 

indirect address / 




from address 

the first location in real core which is to be displayed. 

to address 

the last location in core to be displayed; this operand may be defaulted if only one 
word is to be displayed. 

format 

the format in which the defined core storage area is to be presented on the 1052-7 
console, codes as follows: 

X-hexadecimal full word 

C-EBCDIC 

b -blank, will assume X is desired 



ii 



Display Resident Monitor Status 



Command Operation 


Command Operand 


DIS 




PSW 
EXPSW 






saved status - { 


SVCPSW 
PGPSW 
IOPSW 
MCPSW 





Where saved status is the status of TSS/360 to be displayed. 

PSW - current PSW 

EXPSW - old external PSW 

SVCPSW - old SVC PSW 

PCPSW - old program check PSW 

IOPSW - old I/O PSW 

MCPSW - old machine check PSW 

Display CAW/CSW 



Command 



Operand 



DIS 



CAW 
CSW 



CAW 

coded value, for channel address word 
CSW 

coded value, for channel status word 
Note : The fields of the CAW and CSW will be labeled and displayed in hexadecimal. 
Display Registers 



Command 


Operand 


DIS 


|Gr) , <freg number fhex 11 
/CR> 1 \integery 
\FRJ 

format*- (X) 


/ 1 reg number - 


fhex 1 
Wteger) 


? 



GR, CR, FR 

coded values; mnemonics for general registers, control registers, and floating point 
registers. 
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reg number 

register number in hexadecimal or decimal. If the optional parameter is coded, the 
register number entered must be higher than the register number. This command 

will display an inclusive range of registers when register number is specified. 

format 

same coded values as for displaying real core. 

Note : For floating point registers, only 0, 2, 4, 6 may be specified as register num- 
bers. 

Error Responses: 

ILLEGAL FORMAT 

f TO f ADDRESS LESS THAN 'FROM 1 ADDRESS 

MISSING PARAMETER 

INVALID REGISTER SPECIFICATION 

INVALID ADDRESS 

Note : All entries of ft reg number 1 ' field can be either decimal or hexadecimal. 

Display Virtual Storage of Current Task 



Command 


Operand 


DIS 


VM, logical from address - 


- hex, logical to address 


- hex, format X 



VM 

coded value, if virtual storage is to be displayed 

logical "from" address 

indicate first virtual location to be displayed. Virtual storage address, as defined in 
TSS/360, is in the form of SSSPPDDD where 

SSS segment number 

PP page number 

DDD displacement 

Only hex characters are valid. 



13 



logical ,f to' f address 

indicates last virtual storage location to be displayed; may be defaulted if only one 
location is to be displayed. 

format (a one -character code) 

X - Hexadecimal fullword 

Display Virtual Registers and Status of Current Task 

To display an inclusive range of general purpose registers. 



Command 


Operand 


DIS 


VM IgrI , register number - 

w 


/integer! 
Ihex J 


/ register number 




[integer] 










\hex J 










format - X 









VM 



virtual memory — a coded value 



GR 



general register — a coded value 
FR 

floating point register — a coded value 
general register number 1 

the first general register to be displayed; may be in hexadecimal or decimal. 

general register number 2 

the last general register to be displayed; if only one register is to be displayed, this 
operand may be defaulted. 

format 

the format in which the contents of the registers are to be displayed; where: 
X - hexadecimal full word. 
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Note: The value of register number must be greater than register number . Only 0, 

^ 1 

2,4, 6 are allowed for FR specification. 
Display a Task Interrupt Old PSW 



Command 


Operand 




- 


"ppsW 

SPSW 




DIS 


VM, pswtype - ^ 


XPSW 
APSW 
TPSW 
IPSW 


\ 



pswtype 

type of PSW to be displayed 

PPSW - virtual program interrupt PSW 

SPSW - virtual SVC PSW 

XPSW - virtual external PSW 

APSW - asynchronous interrupt PSW 

TPSW - timer interrupt PSW 

IPSW - virtual I/O interrupt PSW 

Note : The fields of the PSW are labeled and displayed In hexadecimal. 

Error Responses : 

MISSING PARAMETER 

REQUEST NOT VALID 

'TO T ADDRESS LESS THAN ! FROM ! ADDRESS 

ILLEGAL FORMAT 

INVALID REGISTER SPECIFICATION 

ERROR X IN LOCATING A VM PAGE 

ERROR X IN LOCATING ISA 

ERROR X IN LOCATING XTSI 
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where X Is: 

- page allocated but not assigned to an external device 

1 - segment portion of address Is too large 

2 - segment specified is not assigned to program's virtual storage 

3 - page portion of address is too large 

4 - page table specification error 

5 - error in trying to locate the SYSTEM TABLE (CHBSYS) 

6 - no active TSI on system 

7 - XTSI Is not in core 

8 - reserved code 

9 - no tables are available for converting symbolic device address to an actual 
address 

A- Invalid symbolic device address for an external page 

Display Direct-Access Device Contents 



Command 


Operand 


DIS 


2301 
2311 
2314 



2301, 2311, 2314 

coded values relating to direct-access device type. 

Response : 

UNIT CYL TRK REC FROM TO FORMAT 

The operator must then enter the following parameters, separated by delimiters and 
terminated by EOB. 

UNIT 

symbolic name or physical address of unit to be processed; e.g. , SYSRES, SYS009, 
190, etc. 

CYL 

number of cylinder to be processed. 

TRK 

address of track to be processed; if this field is void, the entire cylinder is 
processed. 



16 
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REC 

number of the record within the track to be processed; if this field is void, the 
entire track (all records) is processed. 

FROM 

relative address of 1st byte of record to process (1-n); assumed 1 if void. 

TO 

relative address of last byte of record to be processed; if this field is void, the 
remainder of the record is processed. 

Format 

C - EBCDIC 

X - hexadecimal 

DUM - Dump 

The dump command provides the STS user with a means of 

1. taking static dumps of real core storage and virtual storage (current task only) 
areas , 

2. dumping the contents of direct-access devices, 

3. dumping a numerically sorted version of the resident monitor symbol table. 

4. dumping certain TSS/360 tables. 

The dump information will be written on the output device assigned to SYS001. The 
1403 printer can be assigned to SYS001 if immediate listing of dump output is desired, 
or SYS001 can be assigned to a tape drive and dump information collected for a later 
tape-to-print operation. At end of reel on SYS001 the assignments for SYS001 and 
SYS010 are swapped (if for same device type and mode) and dumping continues. 



Dump of Real Memory Contents 



Command 



Operand 



DUM 



from . address 



/alphname \ 

1 simple expression? 
j absolute location i 



I indirect address 



/alphname \ 

J simple expression? 
J absolute location i 
(indirect address / 



format - X 



to- address - 

alphname 
J integer 
, dumpid -Shex 

(alphameric 



"from" address 



first location in core in which dumping is desired. 
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M to" address 

last location in core in which dumping is desired, 
format 

format in which the output is to be presented; a one-character code: 

X - Hexadecimal full word 

C - EBCDIC 

b - If blank, f X f will be assumed; if illegal, field will be assumed equal to dumpid. 

dumpid 

1-6 character information for user convenience in identifying the dump. 

Note : Current TSS/360 status is always dumped. 

Response : 

DONE 

Error Responses : 

INVALID CPU SPECIFIED (indicates error in CPU status table) 

MISSING PARAMETER 

f TO ! LOCATION IS LESS THAN r FROM f LOCATION 

INVALID ADDRESS 

DUMP REQUEST SPANS A STORAGE ELEMENT NOT AVAILABLE TO THIS CPU 

Dump of Entire Memory Contents 



Command 


Operand 


DUM 


ALL, uiumpid) 



ALL 

coded value. This command will cause the entire core storage and the saved user 
conditions to be dumped. 

dumpid 

1-6 character information for identifying dump. 
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Dump Direct-Access Device Contents 



Command 


Operand 


DUM 


f230ll 
da-device < 2311 > 
^2314j 



2301, 2311, 2314 

coded values relating to direct- access device type. 

Response : 

UNIT CYL TRK REC FROM TO FORMAT 

The user must then enter the following parameters, separated by delimiters and ter- 
minated by EOB. 

UNIT 

symbolic name or physical address of unit to be processed; e.g. , SYSRES, SYS009, 
+ 190, etc. 



CYL 



address of cylinder to be processed (in case of 2301 drum, CYL must be entered as 
zero). 



TRK 



address of track to be processed; if this field is void, the entire cylinder is pro- 
cessed. 

REC 

number of the record within the track to be processed; if this field is void, the entire 
track (all records) is processed. 

FROM 

relative address of first byte of record to process (1-N); assumed 1 if void. 

TO 

relative address of last byte of record to process; assumed to be the last byte of the 
record if void or if greater than the record length. 
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FORMAT 

a one-character code specifying the format of the text to be processed. 

X - Hexadecimal 
C - EBCDIC 

Note : All numbers must be preceded by an asterisk (*), if decimal. 

Dump of Virtual Memory Contents (Current Task Only) 

The PSWs, general registers, control registers, the task status index (TSI), the ex- 
tended TSI, and shared page tables will be printed followed by that portion of virtual 
storage specified in the command. 



Command 


Operand 


DUM 


VM, from address (logical) - hex 
, to address (logical) - hex , format Jx, 


. , /any 1-6 \ 

dumpid -( . ) 

\ characters/ 





VM 

coded value, to indicate virtual storage dumping, 
logical "from" address 

first virtual storage location to be dumped. 

logical "to" address 

last virtual storage location to be dumped; may be omitted if only one location is to be 
dumped. 

format 

one-character code: 
X - hexadecimal 
dumpid 

1-6 character user Information for identifying his dump. 

Note : "from" and "to" addresses are hexadecimal virtual storage addresses (SSSPPDDD) 
specifying the portion of virtual storage to be dumped. Either both of these or the "to" 
address parameter may be replaced by ALL. 
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Error Responses: 

ERROR IN PARAMETER M 
ERROR TYPE N 

where N is: 

4 page table specification error 

5 system table (CHRSYS) not specified 

6 no active TSI 

7 XTSI not in core 

8 reserved 

9 error searching RSPI 

INVALID UNIT 

INVALID CYLINDER ADDRESS 

INVALID TRACK ADDRESS 

INVALID FIELD 

REQUESTED RECORD NOT FOUND 

FROM ADDRESS TOO LARGE 

TO ADDRESS LESS THAN FROM 

I/O ERROR 

SPECIFIED UNIT NOT A SUPPORTED DIRECT ACCESS DEVICE 

Dump Numerically Sorted Symbol Table 



Command 


Operand 


DUM 


MAP 



MAP 



a coded value; leading to dump of resident supervisor external symbols, numerically 
sorted. 

PAT — Patch 

The PATCH command provides the capability of (1) modifying the contents of real stor- 
age locations, saved register, and current PSW information, (2) entering DDR and CMP 
requests, (3) entering auxiliary real core symbols into the SYMBOL table, (4) modifying 
the contents of virtual storage locations and registers (current task), and (5) modifying 
the contents of direct- access volumes. 



Patch Real Memory 



Command 



Operand 



PAT 



patch-address 



' symbol 
[simple expression ( 
(absolute location 
indirect address 



formal 



© 



content- data 
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patch address 

the first location to be patched, 
format 

a one-character code: 

X - hexadecimal 

C - EBCDIC characters 

content 

supplies replacement data for the core location specified. Data must be supplied in 
integrals of bytes, and start from the core location specified in the patch address. 
The input stream of data will overlay consecutive locations in core until the input is 
exhausted. The "content" is expressed in terms associated with the format speci- 
fied. 

Patch General Registers and PSW 



Command 


Operand 


PAT 


GR, reg. no - ( > , format - \ X > , content- data 



GR 

a coded value for general register. 

regno 

the register into which is loaded the value specified in the 'content* field. 

format 

the format in which the value will be presented to the system for patching. 

a one-character code: 

X - hexadecimal fullword 

content 

this field contains the value which is to be loaded into the specified general register. 
The format of this field must be consistent with the specified format. 
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Patch Floating Point Registers 



Command 


Operand 


PAT 


FR, regno -< > , format - jxj , content-data 



FR 

coded value for floating point registers. 

regno 

the floating point register into which will be loaded the value specified in the content 
field. 

format 

a one-character code: 

X - hexadecimal fullword 

content 

this field contains the value which will be used to replace the current content of the 
specified floating point register. 

Patch Control Registers 



Command 



Operand 



PAT 



{integcer I 
f , content-hex 



CR 

coded value for control register, 
regno 

the control register into which will be loaded the value specified in the content field. 

content 

this field contains a value for loading into the control register; specified in hexa- 
decimal format. 
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Patch PSW Instruction Address 



Command 


Operand 


PAT 


tk?«t ti- • ** jalphaname 1 

PSW, IC. icaddr - < . > 

[simple express ion J 



PSW 



coded value for program status word. 
IC 

coded value for instruction count. 

Icaddr 

the instruction address which is to be replaced in the address portion of the current 
PSW. 



Patch PSW Condition Code/Program Mask 



Command 


Operand 


PAT 


feci 

PSW, {^j- , code or mask - hex 
' [PM] 



PSW 

program status word. 
CC 

condition code. 
PM 

program mask. 

code or mask 

If CC is coded, the condition code will be set (since the CC field of the PSW is two 
bits long, only X ! 0, 1, 2, 3 T are allowed). 

If PM is coded, program mask will be set as specified; hex values thru F are 
valid. 



24 



Form C28 -2035-0 
Page Revised 3/11/68 
By TNL N 28 -3019 



Patch DDR Requests 



Command 



PAT 



Operand 



^-symbol 
simple 
expression 
DR } corloc - / absolute 
location 
indirect 
_ address ^ 



begin 
dum addr 



stop 
dumpaddr 



^symbol 

simple 

expression 
I absolute 

location 

indirect 
v address 



^ 



format ( X } 



^symbol ^ 

simple 

expression 
\ absolute 

location 

indirect 
^ address ^ 



dumpid - 
integer 



> 



DR 

coded value for dump request. 

corloc 

core location; when the instruction address of the PSW matches this specified value, 
a dump is to take place. 

begin dump addr 

the first core location to be dumped, 
stop dump addr 

the last core location to be dumped, 
format 

the format in which the dump is to be written: 

X - hexadecimal fullword 

dumpid 

ID for the dumps belonging to this PAT command, in range of 01-99. When ID is 
greater than 50, the symbol table is not printed. 
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Patch CMP Request 



Command 



Operand 



PAT 



CMP, location, 



location^ 



loc ation - 
n 



/ alphname 
\ simple expression 
\ absolute location 
(indirect address 

/alphname2 
\ simple expression2| 
\ absolute location2 
(indirect address2 



!alphname n 
simple expression n ( 
absolute location n 
indirect address n 



c mpid-intege r 



cmpid-integer 



cmpid- integer 



CMP 

coded value for communication point, which interrupts execution of the problem 
program at the location designated by 'location \ and establishes terminal com- 
munications between the operator and the STS manual mode of operation, after 
saving resident monitor status, 

location 

the location for passing control to STS manual mode. 

cmpid 

two-character decimal code, associated with each CMP location; valid values from 
01-99. 

Patch TSS/360 Resident Supervisor Addressing Symbol 



Command 


Operand 


PAT 


SYM, symbol name-alphameric , value - f simple expression^ 



SYM 

a value to be coded as shown, 
symbol name 

the symbol to be entered into the symbol table of the resident supervisor. 
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value 

a relative addressing value, formed by adding or subtracting a displacement from an 
existing symbol. After execution of the command, the location associated with the 
value may be addressed by the assigned symbol name. 

For example, if a new symbol NEWCMP is to be added to the symbol table, which is 
20 bytes from an existent symbol LOOP, the operator may code 

PAT SYM, NEWCMP, LOOP+*20 in decimal 

or 

PAT SYM, NEWCMP, LOOP +14 

After execution of this command, the new symbol NEWCMP is used to reference a 
location. 

Patch Via CARDS 



Command 


Operand 


PAT 


CARDS 



CARDS 

coded value 

This command facilitates the input of successive PATCH commands. By issuing 
this command on the 1052-7 console, prepunched PATCH commands will be read 
in from SYSIPT, and processed in the same manner as if entered via the console. 

Note : A PAT END card or a blank card should be the last of the PATCH deck, to indi- 
cate the end of input. Column 1 of this card must be blank. 

Patch Registers and PSW of Current Virtual Memory Task 



Command 



Operand 



PAT 



/ GR l 

VM, reg type < FR > , regno- 
lCR| 

content- data 



finteg 
\hex 



erl 



format - X 



VM 



coded value operand. 
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reg type 

type of register for patching. 
GR 

coded value for general register patching. 
FR 

coded value for floating point register patching. 
CR 

coded value for control register patching. 

regno 

the register number in hex or decimal that is desired; may be specified in decimal 
or hexadecimal. 

for FR, only 0, 2, 4, 6 are valid. 

format 

the format into which the input data, as specified in the content field, must be 
converted before it is loaded into the register. 

X - hexadecimal fullword, valid for all reg types. 

Patch IC/CC/PM 



Command 


Operand 






f IC \ 




PAT 


VM, PSW, pswfld - 


\ cc (' 

(PMj 


code or logical location- hex 



VM 

coded value operand. 
PSW 

coded value operand, 
pswfld 

fields in PSW to be set. 
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IC - fields in PSW - instruction counter 
CC - fields in PSW - condition code 
PM - fields in PSW - program mask 

code or logical location 

if IC is coded, logical location is used, in the format of SSSPPDDD as in the PATCH 
virtual memory (current task) illustration. If CC is coded, only a one-character 
hex character within the value of 0-3 is allowed. If PM Is specified all hex digits or 
value 0-F are allowed. 

Response : 

DONE 

Error Responses : 

INVALID ADDRESS 

INVALID FORMAT 

INVALID REGISTER 

INVALID DUMP PARAMETER 

INVALID PARAMETER 

INVALID ID 

INVALID SYMBOL 

BAD BOUNDARY ALIGNMENT 

DUMP REQUEST TABLE FULL (max. #50) 

CMP TABLE FULL (max. #50) 

NON-REPLACEABLE INSTRUCTION 

PATCH WILL EXCEED CORE LIMITS 

FROM ADDRESS EXCEEDS THRU ADDRESS 

EDITING ERROR 

PATCH EXTENDS INTO CORE BOX NOT ASSIGNED 

Patch Virtual Memory (Current Task) 



Command 


Operand 


PAT 


VM, logical address - 


- hex, format - < 


. 1 , content - 


data 



VM 

coded value, 
logical address 

the logical address of virtual storage to be patched, in the form SSSPPDDD 
where 
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SSS = segment 

PP = page 

DDD = displacement 

If more than one byte is to be patched, the input information will overlay success- 
ive virtual storage locations until the input stream is exhausted. 



format 



indicates to STS the format of the input data, and any necessary conversion to EBCDIC 
code will be performed 

where: 

C - EBCDIC character 
X - hexadecimal 

content 

the input information to be used for patching the VM locations; a maximum of 32 bytes 
is allowed for each command; they must be integral numbers of bytes; e.g. , 2A432 
in the content field will produce an erroneous result. 

Error Responses : 

ILLEGAL LOCATION FIELD 

ILLEGAL FORMAT FIELD 

EXCESSIVE PATCH DATA* 

NO PATCH DATA 

ILLEGAL HEX CHARACTER 

ILLEGAL ADDRESS ALIGNMENT 

INVALID REQUEST - TSS NOT THE USER 

Patch Contents of Direct- Access Device 



COMMAND 


OPERAND 


PAT 


C230l\ 

da-device ( 2311 > 

(2314/ 



da- device 

coded value operand for direct- access device patching. 



*A maximum of 32 bytes may be patched with one usage of the PAT VM command. 



30 



Response : 

UNIT CYL TRK REC AT FORMAT TEXT 

The user must then enter the following parameters, separated by delimiters and ter- 
minated by EOB: 

UNIT 

symbolic name or physical address of unit to be processed; e. g. , SYSRES, SYS009, 
+190, etc. 

CYL 

address of cylinder to be processed (in case of 2301 drum, CYL must be entered as 
zero). 

TRK 

address of track to be processed; if this field is void, the entire cylinder is processed. 

REC 

number of this record within the track to be processed; if this field is void, the 
entire track (all records) is processed. 

AT 

relative address of first byte of record to process (1-N); assumed 1 if void. 
FORMAT 

one-character code specifying the format of the text to be processed. 

X - hexadecimal 
D - EBCDIC 

TEXT 

contents to patch into record 

Note : All numbers must be preceded by an asterisk (*) if decimal. After the device 
type has been determined, the desired patch is made. 

Error Responses : 

INVALID UNIT 

INVALID CYLINDER ADDRESS 
INVALID TRACK ADDRESS 
INVALID TEXT CODE 
INVALID FIELD 
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REQUESTED RECORD NOT FOUND 

I/O ERROR 

SPECIFIED UNIT NOT A SUPPORTED DIRECT ACCESS DEVICE 

NO TEXT FIELD 

DEL — Delete 

The DEL command provides the capability of deleting dump requests and communication 
points from the STS program control table (PCT), which is constructed by STARTUP 
and filled by the PAT command. 



Command 


Operand 


DEL 


fALLl fsymbol 1 
< CMP \ 1, location - < simple expression^ J ^id-integer J 
IJDDRJ ^absolute location J 



ALL 



coded valve implying deletion of all DDR and CMP requests. 

CMP 
DDR 

coded values Implying communication point and dynamic dump request, respectively; 
must be coded as shown. 

location 

further specifies the particular DDR and CMP locations that were created previously 
(see PAT command); if defaulted all DDRs and CMPs will be deleted. 

id 

the ID given in previous DDR or CMP of a PAT command; default results in deletion 
of all DDRs and CMPs at that address. 

Response: 

DONE 

Error Responses: 

INVALID ID 

INVALID ADDRESS 

NO ENTRY AT THIS ADDRESS 
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SET — Set Control Function Status 

The SET command allows the user to activate and deactivate the various control func- 
tions related to STS/TSS operations: 

(1) Pausing virtual task execution 

(2) Establishing 2702 lines to be enabled upon restore froni checkpoint; this may be 
used only when the TSS monitor is in core and before it has been run. 

This command is used to set the pause mechanism, for a particular task, on or off. 
A task is "paused 11 (if the TSI pause bit is on) each time the dispatcher is about to run 
the task. A message, which identifies the task, is printed on the 1052 when a task 
pauses as: 

TASK PAUSE: USER- ID = XXXX DEVID = XX TASKED = XXXX 

The user then has control at the 1052 console and may display, patch, etc. , or 
continue running as he desires. 

Set Pause for Virtual Task 



Command 


Operand 


SET 


PAUSE, tsi pause bit J°!Li 

I Or Jb J 



PAUSE 

coded value for the pause mechanism. 

tsi pause bit 

as name implies, ON and OFF are coded values for setting the TSI pause bit of a 
particular task on and off, respectively. 

SAMPLE: 

Entry: SET PAUSE ON 

Response: CONV/BATCH USER— ID 
Entry: CONV USER— ID 

or 

BATCH USER— ID 

(User — ID Is the 1- to 8-character user identification for the task.) 
Response: OK 
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Error Responses: 

YOU ARE IN THE MIDDLE OF A PAUSE NOW 

ENTER— RUN— THEN SET PAUSE OFF AFTER TASK PAUSES 

Task is in the process of pausing and the current request cannot be accepted. 

NO ENTRY WITH MATCHING USER-ID 

NO MATCH FOUND IN ACTIVE SCAN 

A search of the active chain of TSIs produced no USER-ID matching the one 
specified. 

or 

a matching USER-ID was found, but not in CONV/BATCH mode. 

THERE ARE NO ACTIVE TASKS 

The first byte in CHBSYS, the pointer to the first active TSI, contains zeros. 

THERE ARE NO INACTIVE TASKS. 

The pointer to the first inactive task contains zeros. 

NO MATCH FOUND IN INACTIVE SCAN. 

A search of the inactive chain of TSIs produced no USER-ID matching the one 
specified, 

or 

a matching USER- ID was found, but not in CONV/BATCH mode. 
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APPENDIX 



Supervisor and transient processor short form messages to operator 

During execution of transient processors certain messages may appear on the 1052-7 
which relate to operator intervention that may be needed in connection with an I/O device 
or may relate to a particular illogical condition the solution to which depends on operator 
choice. All such messages are distinguished by a proceed condition which is established 
at the 1052-7 following a five-character message ending with A. To all such messages, 
the following responses apply: 

- Enter command recognition routine by fetching new copy from STS data set. 

1 - Dump all of real core and return to command recognition routine. 

2 - Set user program switch indicator (UPSI) bit 7 on and return to program that 

issued message. 

3 - Set user program switch indicator (UPSI) bit 7 off and return to program that 

issued message. 

Ignore I/O operation and continue, or if following ATT2A message, record 
attention and give later retry I/O operation (condition has been corrected); if 
following ATT1A or ATT2A message; ignore request for attention 
Following ATT1A or ATT2A message: give attention anyway, otherwise return 
to program issuing message. 
7,8,9, or return to program issuing message . 

any character 

? - enter command recognition routine. 

These responses are made to communicate operator intention to the program issuing 
the message. The majority of such messages originate within the STS supervisor but 
transient programs may use this mechanism for obtaining one character operator 
responses. Such usage by transient processors is discussed in the sections relating to 
the specific processor. Note that responses 5-9 and other characters not indicated above 
are for use of the transient processors. 

Messages relating to operator intervention with I/O devices are distinguished by their 
being issued in two parts. Below is an example of operator intervention necessary to 
ready a printer to complete a dump: 

DUM CEAJIL CEAJIL+1000 command to dump 

0030 address of printer 

4000 A two bytes sense data 

5 operator response 

? command completed 

Other messages issued by the supervisor are: 

USDVA An error has occurred on an unsupported I/O device. 

CCUU 

CHECK An unexpected unit check has occurred on device indicated by CCUU. 
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Absolute location, operand 4 
Alphname, operand 5 
Alternate choices, operand 6 
Alternate code key 4 
Appendix 35 

ASN command (see assign device address) 
Assign device address command 2, 8 
Attention button 1 



Basic operating system (see BOS) 
BOS 1 

Brackets, notational symbol 6 
Braces, notational symbol 7 
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Display 2, 11-17 

direct access device contents 

real storage 11 

resident monitor status 12 

status of current task 1 4 

virtual registers of current task 

virtual storage of current task 
DUM command (see dump) 
Dump 3, 17-21 

direct access device contents 19 

numerically sorted symbol table 21 

real memory contents 17 

request virtual memory contents 20 
Dynamic dump request 1 



Change mode of system operation 

Character string 5 

CMP (see communication point) 

Coded values, operand 5-6 

Command 

description 4 

entry 4 

format 4 

modify system 1 

name 4 

notation 4 

operand 4 

operation 4 

recognition 2 

recognition routine 1 
Commands, STS 2 

ASN (assign device address) 

DEL (delete) 

DIS (display) 

DUM (dump) 

PAT (patch) 

PSV (assign device address) 

RUN (execute user program) 

SET (set control function status) 
Communication points 1 
Communication region 1 
Console interrupt key 2 
Console typewriter attention button 
Core assignment 1 
Core image library 2 
CPU interrupt key 1 



Execute user program (see RUN) 
Expression, simple 5 



Hexadecimal 5 
Hyphen 5 



Integer, operand 5 
Interface to TSS 1 
Interrupt key 1 
Interrupt stacker 2 
Intervention, operator 35 
IPL 1 



Loading of the STS supervisor 1 



Mandatory operand 7 

Messages, short form 35 

Messages, supervisor 35 

Mode bytes 9 

Mode, normal 1 

Mode of system operation, change 



Name, operand 4 
Normal mode 1 
Notational symbols 5-6 

braces 5 

brackets 5 



DDR (see dynamic dump request) 

Default option 6 

DEL command (see delete) 

Delete 3, 32 

Delimiters 4 

Density 9 

Device mode table 9 

Device type table 8-9 

DIS command (see display) 



Operand 

absolute location 
alphname 5 
alternate choices 
code 5 

coded values 5 
field 4 
hexadecimal 5 
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integer 5 
mandatory 7 
name 4, 6 
positional 4 
representation 4 
simple expression 5 
Operation field 4 
Operator intervention 35 
Operator messages 35 
Optional choices 6 



Parity 9 

PAT command (see patch) 

Patch 3, 21-32 

CMP 26 

contents of direct access device 30 

DDR 25 

machine registers 22 

PSW 22, 24 

PSW of current virtual memory task 27 

real memory 21 

registers of current virtual memory task 27 

TSS resident supervisor addressing symbol 26 

virtual memory of current task 29 
Positional operands 4 
Positional parameters 5 
Program control table 1 
PSV command (see assign device address) 
PSW 1 

Resident monitor, TSS 1 
Responses, operator 35 
RIM command 1, 2, 10 



Stacking of interrupts 1 
STARTUP 1 
Status of system 1 
String of characters 5 
STS 

basic structure 1 

commands 2 

definition 1 

interface 1 

operating concepts 1 

supervisor loading 1 
Supervisor messages 35 
Supervisor, STS loading 1 
Support attention 2 
Support for time sharing (see STS) 
Support mode 1 
Support supervisor 1 
SVC 5 2 
SVC 6 2 
SVC 10 2 
Symbol 4 
Symbol table 1 

Symbols, notational (see notational symbols) 
Sysname 8 

System initialization time 1 
System residence volume 1, 2 
System status 1 
System summary 1 



Transient processor 2 

Translator 9 

TSS resident monitor interface 



Save area space 1 

Saving system status 1 

SET command 3, 33-34 

Set control function status (see SET) 

Short form, operator messages 35 

Simple expression, operand 5 
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